ICEnroll::get_ProviderName-Methode (xenroll.h)

Artikel
03/04/2024

[Diese Eigenschaft ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Die ProviderName-Eigenschaft legt den Namen des zu verwendenden Kryptografiedienstanbieters (CSP ) fest oder ruft diesen ab.

Wenn der CSP nicht angegeben wurde, lautet der Standardwert für diese Eigenschaft "Microsoft Base Cryptographic Provider", und die ProviderName-Eigenschaft ist auf eine leere Zeichenfolge festgelegt. Diese Eigenschaft wurde zuerst in der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_ProviderName(
  BSTR *pbstrProvider
);

Parameter

pbstrProvider

Rückgabewert

Keine

Bemerkungen

Die ProviderName-Eigenschaft wirkt sich auf das Verhalten der folgenden Methoden aus:

Beispiele

BSTR     bstrProvName = NULL;
BSTR     bstrMyProvName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the ProviderName
hr = pEnroll->get_ProviderName( &bstrProvName );
if (FAILED( hr ))
    printf("Failed get_ProviderName - %x\n", hr );
else
    printf( "ProviderName: %ws\n", bstrProvName );
// free BSTR when done
if ( NULL != bstrProvName )
    SysFreeString( bstrProvName );

// set the ProviderName value
bstrMyProvName = SysAllocString(TEXT("Microsoft Base DSS")
                                TEXT(" Cryptographic Provider"));
hr = pEnroll->put_ProviderName( bstrMyProvName );
if (FAILED( hr ))
    printf("Failed put_ProviderName - %x\n", hr );
else
    printf( "ProviderName set to %ws\n", bstrMyProvName );
// free BSTR when done
if ( NULL != bstrMyProvName )
    SysFreeString( bstrMyProvName );

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xenroll.h
Bibliothek	Uuid.lib
DLL	Xenroll.dll

Freigeben über