FreeCryptProvFromCertEx-Funktion

  • Artikel

Die FreeCryptProvFromCertEx-Funktion gibt das Handle entweder für einen Kryptografiedienstanbieter (Cryptographic Service Provider , CSP) oder für einen CNG-Schlüssel (Cryptography API: Next Generation) frei.

Hinweis

Diese Funktion verfügt über keine zugeordnete Headerdatei oder Importbibliothek. Um diese Funktion aufzurufen, müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress zum dynamischen Verknüpfen mit Mssign32.dll verwenden.

 

Syntax

void WINAPI FreeCryptProvFromCertEx(
  _In_     BOOL                            fAcquired,
  _In_     HCRYPTPROV_OR_NCRYPT_KEY_HANDLE hProv,
           DWORD                           dwKeySpec,
  _In_opt_ LPWSTR                          pwszCapiProvider,
  _In_     DWORD                           dwProviderType,
  _In_opt_ LPWSTR                          pwszTmpContainer
);

Parameter

fAcquired [in]

Ein Wert, der angibt, ob das Anbieterhandle aus dem Zertifikat abgerufen wurde.

hProv [in]

Ein Handle für einen CAPICOM-CSP oder ein Handle für einen CNG-Schlüssel.

dwKeySpec

Die Adresse einer DWORD-Variablen , die zusätzliche Informationen zum Schlüssel empfängt. Dies kann einer der folgenden Werte sein.

Wert Bedeutung
AT_KEYEXCHANGE
 Das Schlüsselpaar ist ein Schlüsselaustauschpaar.
AT_SIGNATURE
 Das Schlüsselpaar ist ein Signaturpaar.
CERT_NCRYPT_KEY_SPEC
 Der Schlüssel ist ein CNG-Schlüssel.
Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.

 

pwszCapiProvider [in, optional]

Ein Zeiger auf eine NULL-Zeichenfolge für den Anbieternamen.

dwProviderType [in]

Gibt den CSP-Typ an. Dies kann null oder einer der Kryptografieanbietertypen sein. Wenn dieses Element 0 ist, ist der Schlüsselcontainer einer der CNG-Schlüsselspeicheranbieter.

pwszTmpContainer [in, optional]

Ein Zeiger auf eine NULL-Zeichenfolge für den Namen des Temporären Schlüsselcontainers.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 R2 [nur Desktop-Apps]
DLL
Mssign32.dll