COSERVERINFO 構造体 (objidlbase.h)

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

構文

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

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

要件

こちらもご覧ください

ライセンス認証のセキュリティ

COAUTHINFO

CoCreateInstanceEx

CoGetClassObject

CoGetInstanceFromFile

CoGetInstanceFromIStorage

アクティブ化のセキュリティをオフにする