Funzione CryptEnumOIDFunction (wincrypt.h)

Articolo
03/09/2024

La funzione CryptEnumOIDFunction enumera le funzioni OID (OID) dell'identificatore dell'oggetto registrato. Le funzioni OID enumerate possono essere schermate per includere quelle identificate dal tipo di codifica, dal nome della funzione, dall'OID o da qualsiasi combinazione di tipo di codifica, nome della funzione e OID. Per ogni funzione OID corrispondente ai criteri di selezione, viene chiamata una funzione di callback fornita dall'applicazione, pfnEnumOIDFunc.

Sintassi

BOOL CryptEnumOIDFunction(
  [in] DWORD                   dwEncodingType,
  [in] LPCSTR                  pszFuncName,
  [in] LPCSTR                  pszOID,
  [in] DWORD                   dwFlags,
  [in] void                    *pvArg,
  [in] PFN_CRYPT_ENUM_OID_FUNC pfnEnumOIDFunc
);

Parametri

[in] dwEncodingType

Specifica il tipo di codifica da corrispondere. Impostando questo parametro su CRYPT_MATCH_ANY_ENCODING_TYPE corrisponde a qualsiasi tipo di codifica. Si noti che se CRYPT_MATCH_ANY_ENCODING_TYPE non è specificato, è necessario un certificato o un tipo di codifica dei messaggi . Se la parola a basso ordine che contiene il tipo di codifica del certificato è diverso da zero, viene usata; in caso contrario, viene usata la parola ad ordine elevato contenente il tipo di codifica del messaggio. Se vengono specificati entrambi, viene usato il tipo di codifica del certificato nella parola a basso ordine.

I tipi di codifica attualmente definiti sono:

CRYPT_ASN_ENCODING
X509_ASN_ENCODING
PKCS_7_ASN_ENCODING
CRYPT_MATCH_ANY_ENCODING_TYPE

[in] pszFuncName

Nome di una funzione per cui viene eseguita una ricerca di corrispondenza senza distinzione tra maiuscole e minuscole. Se si imposta questo parametro su NULL , viene trovata una corrispondenza per qualsiasi nome di funzione.

[in] pszOID

Se la parola ad ordine elevato di pszOID non è zero, pszOID specifica l'identificatore dell'oggetto per cui viene eseguita una ricerca di corrispondenza senza distinzione tra maiuscole e minuscole. Se la parola ad ordine elevato di pszOID è zero, pszOID viene usata per corrispondere a un identificatore di oggetto numerico. L'impostazione di questo parametro su NULL corrisponde a qualsiasi identificatore di oggetto. L'impostazione di questo parametro su CRYPT_DEFAULT_OID limita l'enumerazione solo alle funzioni predefinite.

[in] dwFlags

Riservato per l'uso futuro e deve essere zero.

[in] pvArg

Puntatore agli argomenti da passare alla funzione di callback CRYPT_ENUM_OID_FUNCTION .

[in] pfnEnumOIDFunc

Puntatore alla funzione di callback eseguita per ogni funzione OID corrispondente ai parametri di input. Per informazioni dettagliate, vedere CRYPT_ENUM_OID_FUNCTION.

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.

Requisiti

Requisito	Valore
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