Metode ICEnroll::get_RequestStoreName (xenroll.h)

Artikel
08/28/2023

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

Properti RequestStoreName mengatur atau mengambilICEnroll nama penyimpanan yang berisi sertifikat dummy. Sertifikat dummy ini, bersama dengan kunci privat yang ditambahkan, tetap berada di penyimpanan permintaan hingga otoritas sertifikasi memproses permintaan dan merespons dengan PKCS #7.

Nilai default untuk properti ini adalah "REQUEST". Jika default tidak digunakan, properti ini harus diatur ke penyimpanan yang akan digunakan sebelum panggilan untuk membuatPKCS10 atau createFilePKCS10 dan lagi sebelum panggilan ke acceptPKCS7 atau acceptFilePKCS7.

Properti ini pertama kali didefinisikan dalam antarmuka ICEnroll .

Properti ini bersifat baca/tulis.

Sintaks

HRESULT get_RequestStoreName(
  BSTR *pbstrName
);

Parameter

pbstrName

Mengembalikan nilai

Tidak ada

Keterangan

Biasanya, modifikasi properti RequestStoreName hanya dilakukan dalam aplikasi tingkat lanjut. Mengubah nilai ini tidak disarankan untuk sebagian besar aplikasi.

Properti RequestStoreName 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_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 );

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