Funzione CryptGetDefaultOIDDllList (wincrypt.h)

Articolo
08/27/2023

La funzione CryptGetDefaultOIDDllList acquisisce l'elenco dei nomi dei file DLL che contengono funzioni OID (OID ) predefinite registrate per un set di funzioni e un tipo di codifica specificati.

Sintassi

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

Parametri

[in] hFuncSet

Handle del set di funzioni ottenuto in precedenza da una chiamata a CryptInitOIDFunctionSet.

[in] dwEncodingType

Specifica il tipo di codifica da corrispondere. Attualmente vengono usati solo X509_ASN_ENCODING e PKCS_7_ASN_ENCODING; Tuttavia, è possibile aggiungere altri tipi di codifica in futuro. Per corrispondere a entrambi i tipi di codifica correnti, usare:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Nota È necessario un certificato o un tipo di codifica dei messaggi . X509_ASN_ENCODING è il valore predefinito. Se tale tipo è indicato, viene usato; in caso contrario, se il tipo di PKCS7_ASN_ENCODING è indicato, viene usato.

[out] pwszDllList

Puntatore a un buffer per ricevere l'elenco di zero o più nomi di file con terminazione null. L'elenco restituito viene terminato con un carattere NULL terminante. Ad esempio, un elenco di due nomi può essere:

L"first.dll\0" L"second.dll\0" L"\0"

Per recuperare il numero di caratteri wide che il buffer deve contenere, questo parametro può essere NULL. Per altre informazioni, vedere Recupero dei dati di lunghezza sconosciuta.

[in, out] pcchDllList

Puntatore a un DWORD che specifica le dimensioni, in caratteri wide, dell'elenco restituito a cui fa riferimento il parametro pwszDllList . Quando la funzione restituisce, la variabile puntata dal parametro pcchDllList contiene il numero di caratteri wide archiviati nel buffer.

Nota Quando si elaborano i dati restituiti nel buffer, le applicazioni devono usare le dimensioni effettive dei dati restituiti. Le dimensioni effettive possono essere leggermente inferiori rispetto alle dimensioni del buffer specificato nell'input. In input, le dimensioni del buffer vengono in genere specificate abbastanza grandi per garantire che i dati di output più grandi possibili si adattano al buffer. Nell'output la variabile a cui punta questo parametro viene aggiornata per riflettere le dimensioni effettive dei dati copiati nel buffer.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce non zero (TRUE).

Se la funzione ha esito negativo, restituisce zero (FALSE). Per informazioni sull'errore estese, chiamare GetLastError.

Questa funzione contiene i codici di errore seguenti.

Codice restituito	Descrizione
ERROR_MORE_DATA	Se il buffer specificato dal parametro pwszDllList non è sufficiente per contenere i dati restituiti, la funzione imposta il codice ERROR_MORE_DATA e archivia le dimensioni del buffer necessarie, in caratteri wide, nella variabile puntata da pcchDllList.

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll

Vedi anche

Funzioni di supporto OID

Condividi tramite