ICEnroll2::addNameValuePairToSignature メソッド (xenroll.h)

[このメソッドは、Windows Server 2008 および Windows Vista では使用できなくなりました。

addNameValuePairToSignature メソッドは、属性の認証済みの名前と値のペアを要求に追加します。 名前と値のペアの意味を解釈するのは 、証明機関 (CA) の責任です。 このメソッドは、 ICEnroll2 インターフェイスで最初に定義されました。

構文

HRESULT addNameValuePairToSignature(
  [in] BSTR Name,
  [in] BSTR Value
);

パラメーター

[in] Name

国/地域名の "2.5.4.6" などの属性の名前。

[in] Value

属性の値 ("US" など)。

戻り値

VB

戻り値は HRESULT で、呼び出 しが 成功した場合S_OKが返されます。

注釈

addNameValuePairToSignature メソッドは、要求に属性を追加するために使用されます。

例

BSTR bstrName = NULL;
BSTR bstrValue = NULL;
HRESULT hr;

// Allocate the name. Alternatively, (L"2.5.4.6").
bstrName = SysAllocString(TEXT(szOID_COUNTRY_NAME));
// Allocate the value.
bstrValue = SysAllocString(L"US");

if (NULL == bstrName || NULL == bstrValue)
{
    // handle error
}

// add the name-value pair to the signature
// pEnroll is previously instantiated ICEnroll4 interface pointer
hr = pEnroll->addNameValuePairToSignature( bstrName, bstrValue );
if ( FAILED( hr ) )
    printf("Failed addNameValuePairToSignature - %x\n", hr );
else
    printf("addNameValuePairToSignature(%ws, %ws) succeeded\n",
            bstrName, 
            bstrValue );

// free BSTRs
if (bstrName )
    SysFreeString( bstrName );
if (bstrValue )
    SysFreeString( bstrValue );

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	xenroll.h
Library	Uuid.lib
[DLL]	Xenroll.dll