AuthzInitializeRemoteResourceManager function

The AuthzInitializeRemoteResourceManager function allocates and initializes a remote resource manager. The caller can use the resulting handle to make AuthZ calls over RPC to a remote instance of the resource manager configured on a server.

Syntax

C++
Copy 

BOOL WINAPI AuthzInitializeRemoteResourceManager(
  _In_  PAUTHZ_RPC_INIT_INFO_CLIENT    pRpcInitInfo,
  _Out_ PAUTHZ_RESOURCE_MANAGER_HANDLE phAuthzResourceManager
);

Parameters

pRpcInitInfo [in]

Pointer to an AUTHZ_RPC_INIT_INFO_CLIENT structure containing the initial information needed to configure the connection.

phAuthzResourceManager [out]

A handle to the resource manager. When you have finished using the handle, free it by calling the AuthzFreeResourceManager function.

Return value

If the function succeeds, the function returns TRUE.

If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Examples

C++
Copy 

AUTHZ_RESOURCE_MANAGER_HANDLE resManager;
PWSTR objectUuid = L"9a81c2bd-a525-471d-a4ed-49907c0b23da";    
PWSTR protSeq = L"ncacn_ip_tcp";

AUTHZ_RPC_INIT_INFO_CLIENT rpcInitInfo = {
    AUTHZ_RPC_INIT_INFO_CLIENT_VERSION_V1,
    objectUuid1,
    protSeq,
    "myserver.fabrikam.com",
    NULL,
    NULL,
    NULL // compute default SPN
    };

if (FALSE == AuthzInitializeRemoteResourceManager(
                 &rpcInitInfo,
                 &resManager))
{
    return GetLastError();
}

// proceed to use the returned resManager handle with supported Authz calls

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header
Authz.h

Library
Authz.lib

DLL
Authz.dll

 

 

Show: