ICEnroll：：get_RequestStoreName 方法 (xenroll.h)

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

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

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

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

這是可讀寫的屬性。

語法

HRESULT get_RequestStoreName(
  BSTR *pbstrName
);

參數

pbstrName

傳回值

無

備註

一般而言，只有在進階應用程式中才執行 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