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 |