windows-xp/Source/XPSP1/NT/base/pnp/cfgmgr32/rpcbind.c

/*++

Copyright (c) 1995-2001  Microsoft Corporation

Module Name:

    rpcbind.c

Abstract:

    This module contains the RPC bind and un-bind routines for the
    Configuration Manager client-side APIs.

Author:

    Paula Tomlinson (paulat) 6-21-1995

Environment:

    User-mode only.

Revision History:

    21-June-1995     paulat

        Creation and initial implementation.

--*/


//
// includes
//
#include "precomp.h"
#include "cfgi.h"



handle_t
PNP_HANDLE_bind (
    PNP_HANDLE   ServerName
    )

/*++

Routine Description:

    This routine calls a common bind routine that is shared by all
    services. This routine is called from the PNP API client stubs
    when it is necessary to bind to a server. The binding is done to
    allow impersonation by the server since that is necessary for the
    API calls.

Arguments:

    ServerName - A pointer to a string containing the name of the server
        to bind with.

Return Value:

    The binding handle is returned to the stub routine.  If the
    binding is unsuccessful, a NULL will be returned.

--*/

{
    handle_t    BindingHandle;
    RPC_STATUS  Status;


    Status = RpcpBindRpc(
                ServerName,         // UNC Server Name
                L"ntsvcs",
                L"Security=Impersonation Dynamic True",
                &BindingHandle);

    //
    // the possible return codes from RpcpBindRpc are STATUS_SUCCESS,
    // STATUS_NO_MEMORY and STATUS_INVALID_COMPUTER_NAME.  Since the format
    // of the bind routine is fixed, set any errors encountered as the last
    // error and return NULL.
    //
    if (Status != STATUS_SUCCESS) {

       BindingHandle = NULL;

       if (Status == STATUS_NO_MEMORY) {
         SetLastError(ERROR_NOT_ENOUGH_MEMORY);
       }
       else if (Status == STATUS_INVALID_COMPUTER_NAME) {
         SetLastError(ERROR_INVALID_COMPUTERNAME);
       }
       else SetLastError(ERROR_GEN_FAILURE);
    }

    return BindingHandle;

} // PNP_HANDLE_bind



void
PNP_HANDLE_unbind (
    PNP_HANDLE    ServerName,
    handle_t      BindingHandle
    )

/*++

Routine Description:

    This routine calls a common unbind routine that is shared by
    all services. It is called from the Browser service client stubs
    when it is necessary to unbind from the server end.

Arguments:

    ServerName - This is the name of the server from which to unbind.

    BindingHandle - This is the binding handle that is to be closed.

Return Value:

    none.

--*/
{
    RPC_STATUS  status;

    UNREFERENCED_PARAMETER(ServerName);

    status = RpcpUnbindRpc(BindingHandle);

    return;

} // PNP_HANDLE_unbind