COSERVERINFO 構造体 (objidlbase.h)

[アーティクル]
03/05/2024

アクティブ化機能に対するリモートコンピューターリソースを識別します。

構文

typedef struct _COSERVERINFO {
  DWORD      dwReserved1;
  LPWSTR     pwszName;
  COAUTHINFO *pAuthInfo;
  DWORD      dwReserved2;
} COSERVERINFO;

メンバー

dwReserved1

このメンバーは予約済みであり、0 である必要があります。

pwszName

コンピューターの名前です。

pAuthInfo

コンピューターのリモートアクティブ化の既定のアクティブ化セキュリティをオーバーライドする COAUTHINFO 構造体へのポインター。それ以外の場合は、既定値を使用する必要があることを示すために NULL に 設定します。詳細については、「解説」を参照してください。

dwReserved2

このメンバーは予約済みであり、0 である必要があります。

注釈

COSERVERINFO 構造体は、主にオブジェクト作成関数でリモートシステムを識別するために使用されます。コンピューターリソースには、ネットワークトランスポートの名前付けスキームを使用して名前が付けられます。既定では、すべての UNC ("\\server" または "server") と DNS 名 ("domain.com"、"example.microsoft.com"、または "135.5.33.19" の名前が許可されます。

pAuthInfo が NULL に設定されている場合、クライアントとサーバーの間で動作する認証サービスをネゴシエートするために Snego が使用されます。ただし、次のいずれかのニーズを満たすために、pAuthInfo に NULL 以外の COAUTHINFO 構造体を指定できます。

コンピューターのリモートアクティブ化に別のクライアント ID を指定するには。指定された ID は、実際のクライアント ID ではなく、サーバー上の起動アクセス許可チェックに使用されます。
NTLMSSP ではなく Kerberos をコンピューターのリモートアクティブ化に使用するように指定します。既定以外のクライアント ID を指定する場合と指定しない場合があります。
セキュリティで保護されていないアクティブ化を要求する場合。
独自の認証サービスを指定する。

pAuthInfo が NULL でない場合、これらの値を使用してリモート呼び出しの認証設定が指定されます。これらの設定は RpcBindingSetAuthInfoEx 関数に渡されます。

pAuthInfo パラメーターが NULL の場合、dwAuthnLevel は、CoInitializeSecurity 関数によって設定された認証レベルによってオーバーライドできます。 CoInitializeSecurity 関数が呼び出されない場合は、AppID レジストリキーで指定された認証レベルが使用されます (存在する場合)。

Windows XP Service Pack 2 (SP2) 以降では、 dwAuthnLevel は最大RPC_C_AUTHN_LEVEL_CONNECTで、アクティブ化要求を発行するクライアントプロセスのプロセス全体の認証レベルです。以前のバージョンのオペレーティングシステムの場合、これはRPC_C_AUTHN_LEVEL_CONNECT。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
Header	objidlbase.h (Objidl.h を含む)