IX509AttributeClientId::InitializeEncode メソッド (certenroll.h)

  • [アーティクル]

InitializeEncode メソッドは、証明書要求を送信したユーザー、クライアント コンピューター、アプリケーションに関する情報から 属性を初期化します。

構文

HRESULT InitializeEncode(
  [in]           RequestClientInfoClientId ClientId,
  [in, optional] BSTR                      strMachineDnsName,
  [in, optional] BSTR                      strUserSamName,
  [in, optional] BSTR                      strProcessName
);

パラメーター

[in] ClientId

要求を作成したアプリケーションの種類を識別する RequestClientInfoClientId 列挙値。 たとえば、自動登録サービス、コマンド ライン要求ツール、カスタム要求アプリケーションなどがあります。

[in, optional] strMachineDnsName

要求が作成されたコンピューターのドメイン ネーム システム (DNS) 名を含む BSTR 変数 (例: ComputerName.contoso.com)。 名前を指定しない場合、メソッドは GetComputerNameEx 関数を呼び出します。 名前が見つからない場合、メソッドは失敗します。

[in, optional] strUserSamName

DomainName\UserName という形式のユーザーのセキュリティ アカウント マネージャー (SAM) 名を含む BSTR 変数。 名前を指定しない場合、メソッドは GetUserNameEx 関数を呼び出します。 名前が見つからない場合、メソッドは失敗します。

[in, optional] strProcessName

証明書要求を作成したアプリケーションの名前を含む BSTR 変数。 名前を指定しない場合、メソッドは GetCommandLine 関数を呼び出し、コマンド ラインを解析します。 名前が見つからない場合、メソッドは失敗します。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

注釈

この属性の オブジェクト識別子 (OID) は XCN_OID_REQUEST_CLIENT_INFO (1.3.6.1.4.1.311.21.20) です。 詳細については、「 CERTENROLL_OBJECTID」を参照してください。 属性は、Distinguished Encoding Rules (DER) を使用してエンコードされる抽象構文表記 1 (ASN.1) 構造体として作成されます。

IX509AttributeClientId オブジェクトを使用するには、InitializeEncode または InitializeDecode を呼び出す必要があります。 2 つのメソッドは相互に補完し合います。 InitializeEncode メソッドを使用すると、エンコードされた ASN.1 構造体を生データから構築できます。InitializeDecode メソッドを使用すると、エンコードされた ASN.1 構造体から生データを初期化できます。 次のプロパティを呼び出して、生データを取得できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h
[DLL] CertEnroll.dll

こちらもご覧ください

IX509AttributeClientId

InitializeDecode