COAUTHINFO 構造体 (wtypesbase.h)

  • [アーティクル]

クライアント コンピューターからサーバー コンピューターへのリモート ライセンス認証要求を行う際に使用される認証設定が含まれます。

構文

typedef struct _COAUTHINFO {
  DWORD          dwAuthnSvc;
  DWORD          dwAuthzSvc;
  LPWSTR         pwszServerPrincName;
  DWORD          dwAuthnLevel;
  DWORD          dwImpersonationLevel;
  COAUTHIDENTITY *pAuthIdentityData;
  DWORD          dwCapabilities;
} COAUTHINFO;

メンバーズ

dwAuthnSvc

使用する認証サービス。 値の一覧については、「認証サービス定数 」を参照してください。 認証が必要ない場合は、RPC_C_AUTHN_NONEを使用します。 RPC_C_AUTHN_WINNTが既定であり、RPC_C_AUTHN_GSS_KERBEROSもサポートされています。

dwAuthzSvc

使用する承認サービス。 値の一覧については、「承認定数の」を参照してください。 NT 認証サービスを使用するには、RPC_C_AUTHZ_NONEを指定します。

pwszServerPrincName

認証サービスで使用するサーバー プリンシパル名。 RPC_C_AUTHN_WINNTを使用している場合、プリンシパル名は NULLする必要があります。

dwAuthnLevel

使用する認証レベル。 値の一覧については、「認証レベル定数 」を参照してください。

Windows Server 2003 の時点では、リモート ライセンス認証では、CoInitializeSecuritydwAuthnLevel パラメーターで指定された既定の認証レベルが使用されます。 以前のバージョンの Windows では、別のレベルが明示的に指定されていない限り、RPC_C_AUTHN_LEVEL_CONNECTは常にセキュリティ レベルに使用されていました。

dwImpersonationLevel

使用する偽装レベル。 値の一覧については、「権限借用レベル定数を参照してください。 この値はRPC_C_IMP_LEVEL_IMPERSONATE以上である必要があります。

pAuthIdentityData

既定以外のクライアント ID を確立する COAUTHIDENTITY 構造体へのポインター。 このパラメーターが NULL場合は、クライアントの実際の ID が使用されます。 構造体メンバーの値は、認証サービス固有です。 dwAuthnSvc で NTLMSSP または Kerberos ネットワーク認証プロトコルが承認サービスとして使用 指定されていない場合、この値は NULL する必要があります。

dwCapabilities

このプロキシの追加機能を示します。 現在、このメンバーはEOAC_NONE (0x0) またはRPC_C_QOS_CAPABILITIES_MUTUAL_AUTH (0x1) である必要があります。 Kerberos が必要な場合は、RPC_C_QOS_CAPABILITIES_MUTUAL_AUTHを使用します。

備考

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

  • コンピューターのリモート ライセンス認証に別のクライアント ID を指定します。 指定された ID は、実際のクライアント ID ではなく、サーバーでの起動アクセス許可チェックに使用されます。
  • NTLMSSP ではなく Kerberos をコンピューターのリモート アクティブ化に使用するように指定します。 既定以外のクライアント ID が指定されている場合と指定されていない場合があります。
  • セキュリティで保護されていないアクティブ化を要求する。
  • 独自の認証サービスを指定する。
COAUTHINFO 構造を指定すると、DCOM のアクティブ化を NTLMSSP 以外のセキュリティ プロバイダーで正しく動作できます。 DCOM の代替実装との相互運用性のために、リモート ライセンス認証時に使用される追加のセキュリティ情報を指定することもできます。

dwAuthzSvc 、pwszServerPrincName、dwImpersonationLevel、または dwCapabilities を正しくない値に設定し、CoGetClassObject または CoCreateInstanceExを呼び出した場合、これらの関数はE_INVALIDARGまたは同様のエラーを返しません。 既定値は、正しくない値の代わりに使用されます。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
ヘッダー wtypesbase.h (WTypes.h を含む)

関連項目

COSERVERINFO の