Metode ICEnroll::p ut_RootStoreName (xenroll.h)

Artikel
03/04/2024

[Properti ini tidak lagi tersedia untuk digunakan pada Windows Server 2008 dan Windows Vista.]

Properti RootStoreName menetapkan atau mengambil nama penyimpanan akar tempat semua sertifikat akar yang tepercaya dan ditandatangani sendiri secara intrinsik disimpan.

Nilai default untuk properti ini adalah "ROOT". Karena tingkat kepercayaan yang terkait dengan penyimpanan akar, pengguna mungkin diminta (dengan antarmuka pengguna) untuk menerima sertifikat. Meskipun properti ini tidak perlu diubah untuk banyak aplikasi, untuk menghindari antarmuka pengguna yang terkait dengan memercayai sertifikat akar, kemungkinannya adalah mengatur RootStoreName ke "CA".

Properti ini pertama kali didefinisikan dalam antarmuka ICEnroll .

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_RootStoreName(
  BSTR bstrName
);

Parameter

bstrName

Nilai kembali

Tidak ada

Keterangan

RootStoreName memengaruhi perilaku metode berikut:

Kemampuan untuk mengatur properti ini dinonaktifkan ketika Kontrol Pendaftaran Sertifikat dijalankan sebagai kontrol skrip.

Contoh

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 );

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	xenroll.h
Pustaka	Uuid.lib
DLL	Xenroll.dll

Bagikan melalui