Funzione PvkPrivateKeyAcquireContextFromMemory

  • Articolo

Importante

Questa API è deprecata. Microsoft può rimuovere questa API nelle versioni future.

 

La funzione PvkPrivateKeyAcquireContextFromMemory crea un contenitore temporaneo nel provider di servizi di crittografia e carica una chiave privata dalla memoria nel contenitore.

Nota

Questa funzione non ha alcun file di intestazione associato o una libreria di importazione. Per chiamare questa funzione, è necessario creare un file di intestazione definito dall'utente e usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Mssign32.dll.

 

Sintassi

BOOL WINAPI PvkPrivateKeyAcquireContextFromMemory(
  _In_        LPCWSTR    pwszProvName,
  _In_        DWORD      dwProvType,
  _In_        BYTE       *pbData,
  _In_        DWORD      cbData,
  _In_        HWND       hwndOwner,
  _In_        LPCWSTR    pwszKeyName,
  _Inout_opt_ DWORD      *pdwKeySpec,
  _Out_       HCRYPTPROV *phCryptProv,
  _Out_       LPTSTR     *ppwszTmpContainer
);

Parametri

pwszProvName [in]

Puntatore a una stringa con terminazione null che contiene il nome del provider di servizi di dominio di cui viene richiesto il tipo in dwProvType.

dwProvType [in]

Valore DWORD per il tipo CSP. Per altre informazioni sui tipi CSP, vedere Tipi di provider crittografici.

pbData [in]

Puntatore a un buffer per ricevere i dati di contesto. Il chiamante deve fornire questa risorsa.

cbData [in]

Valore DWORD che specifica le dimensioni, in byte, del buffer pbData . Il chiamante deve specificare questo valore.

hwndOwner [in]

Se è necessaria una password per decrittografare i dati di contesto a cui fa riferimento il parametro pbData , questo parametro è un handle per l'elemento padre della finestra di dialogo; in caso contrario, è NULL.

pwszKeyName [in]

Puntatore a una stringa con terminazione null contenente il nome della chiave da recuperare.

pdwKeySpec [in, out, facoltativo]

Puntatore a un valore DWORD che specifica il tipo di chiave. I valori possibili includono AT_KEYEXCHANGE o AT_SIGNATURE.

phCryptProv [out]

Puntatore a un handle per il CSP.

ppwszTmpContainer [out]

Indirizzo di un puntatore a una stringa con terminazione null per il nome del contenitore temporaneo. La funzione PvkPrivateKeyAcquireContextFromMemory fornisce il buffer per questa stringa e la inizializza. Quando si chiama PvkPrivateKeyAcquireContextFromMemory, l'indirizzo deve puntare a un valore NULL .

Valore restituito

Al termine dell'operazione, questa funzione restituisce TRUE. La funzione PvkPrivateKeyAcquireContextFromMemory restituisce FALSE se ha esito negativo.

Requisiti

Requisito Valore
Client minimo supportato
 Windows XP [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
DLL
Mssign32.dll