ICEnroll：:p ut_RequestStoreName 方法 (xenroll.h)

[自 Windows Server 2008 和 Windows Vista 起，這個屬性已不再可供使用。]

RequestStoreName 屬性會設定或擷取ICEnroll 包含虛擬憑證的存放區名稱。 這個虛擬憑證以及新增的私鑰會保留在要求存放區中，直到 證書頒發機構單位 處理要求並回應 PKCS #7 為止。

此屬性的預設值為 「REQUEST」。。 如果未使用預設值，則此屬性必須設定為儲存區，才能呼叫 createPKCS10 或 createFilePKCS10 ，然後在呼叫 acceptPKCS7 或 acceptFilePKCS7 之前再次設定為要使用的存放區。

此屬性最初是在 ICEnroll 介面中定義。

這是可讀寫的屬性。

語法

HRESULT put_RequestStoreName(
  BSTR bstrName
);

參數

bstrName

傳回值

無

備註

一般而言， RequestStoreName 屬性的修改只會在進階應用程式中執行。 不建議對大部分的應用程式變更此值。

RequestStoreName 屬性會影響下列方法的行為：

• acceptPKCS7
• acceptFilePKCS7
• createPKCS10
• createFilePKCS10

當憑證註冊控制執行為腳本控件時，會停用設定此屬性的功能。

範例

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RequestStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName: %ws\n", bstrStoreName );
// free BSTR when done
if ( NULL != bstrStoreName )
    SysFreeString( bstrStoreName );

// set the storename
// bstrNewName is a BSTR that is previously set to a valid store name
hr = pEnroll->put_RequestStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName was set to : %ws\n", bstrNewName );

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	xenroll.h
程式庫	Uuid.lib
Dll	Xenroll.dll