Metode ICEnroll::get_RootStoreName (xenroll.h)

Artikel
08/28/2023

[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 (melalui antarmuka pengguna) untuk menerima sertifikat. Meskipun properti ini tidak perlu diubah untuk banyak aplikasi, untuk menghindari antarmuka pengguna yang terkait dengan sertifikat akar kepercayaan, kemungkinannya adalah mengatur RootStoreName ke "CA".

Properti ini pertama kali didefinisikan dalam antarmuka ICEnroll .

Properti ini bersifat baca/tulis.

Sintaks

HRESULT get_RootStoreName(
  BSTR *pbstrName
);

Parameter

pbstrName

Mengembalikan nilai

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


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