ICEnroll::get_RootStoreName 方法 (xenroll.h)
[自 Windows Server 2008 和 Windows Vista 起,這個屬性已不再可供使用。]
RootStoreName屬性會設定或擷取根存放區的名稱,其中會保留所有內部信任的自我簽署根憑證。
此屬性的預設值為 「ROOT」。 由於與根存放區相關聯的信任層級,可能會提示使用者 (使用者介面) 接受憑證。 雖然許多應用程式都不需要變更此屬性,但為了避免與信任 根憑證相關聯的使用者介面,可能會將 RootStoreName 設定為 「CA」。
此屬性最初是在 ICEnroll 介面中定義。
這是可讀寫的屬性。
語法
HRESULT get_RootStoreName(
BSTR *pbstrName
);
參數
pbstrName
傳回值
無
備註
RootStoreName 會影響下列方法的行為:
當憑證註冊控制執行為腳本控制項時,會停用設定此屬性的功能。
範例
BSTR bstrStoreName = NULL;
HRESULT hr;
// pEnroll is previously instantiated ICEnroll interface pointer
// get the storename
hr = pEnroll->get_RootStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
printf("Failed getting RootStoreName - %x\n", hr );
else
printf( "RootStoreName: %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_RootStoreName( bstrNewName );
if ( FAILED ( hr ) )
printf("Failed setting RootStoreName - %x\n", hr );
else
printf( "RootStoreName was set to : %ws\n", bstrNewName );
規格需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | xenroll.h |
程式庫 | Uuid.lib |
Dll | Xenroll.dll |