COSERVERINFO 構造体 (objidl.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	objidl.h (Objidl.h を含む)