Funzione CryptCATAdminEnumCatalogFromHash (mscat.h)

[La funzione CryptCATAdminEnumCatalogFromHash è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

La funzione CryptCATAdminEnumCatalogFromHash enumera i cataloghi che contengono un hash specificato. L'hash viene in genere restituito dalla funzione CryptCATAdminCalcHashFromFileHandle . Dopo la chiamata finale a questa funzione, chiamare CryptCATAdminReleaseCatalogContext per rilasciare la memoria allocata.

Sintassi

HCATINFO CryptCATAdminEnumCatalogFromHash(
  [in] HCATADMIN hCatAdmin,
  [in] BYTE      *pbHash,
  [in] DWORD     cbHash,
  [in] DWORD     dwFlags,
  [in] HCATINFO  *phPrevCatInfo
);

Parametri

[in] hCatAdmin

Handle a un contesto di amministratore del catalogo assegnato in precedenza dalla funzione CryptCATAdminAcquireContext .

[in] pbHash

Puntatore al buffer che contiene l'hash recuperato chiamando CryptCATAdminCalcHashFromFileHandle.

[in] cbHash

Numero di byte nel buffer allocato per pbHash.

[in] dwFlags

Questo parametro è riservato per l'uso futuro e deve essere impostato su zero.

[in] phPrevCatInfo

Puntatore all'handle al contesto del catalogo precedente o NULL. Per ottenere il primo catalogo contenente l'hash o per avviare un'enumerazione di tutti i cataloghi, passare NULL per questo parametro. Per continuare l'enumerazione, passare il valore restituito della chiamata precedente fino a quando non vengono trovati altri cataloghi.

Valore restituito

Il valore restituito è un handle per il contesto del catalogo o NULL se non sono presenti più cataloghi da enumerare.

Nota: Il tipo HCATINFO è semplicemente un typedef per HANDLE, che semplifica l'uso accidentale di HCATINFO nel contesto errato. In particolare, non è uguale a un HANDLE restituito da CryptCATOpen, anche se il compilatore non impedirà di usare HCATINFO in qualsiasi funzione che prevede un handle di catalogo. Per acquisire un handle di catalogo da questa funzione, chiamare prima CryptCATCatalogInfoFromContext per ottenere il nome file del catalogo e quindi chiamare CryptCATOpen con tale nome file.

Per informazioni sull'errore estese, chiamare la funzione GetLastError . Per un elenco completo dei codici di errore forniti dal sistema operativo, vedere Codici di errore di sistema.

Nota: La funzione restituisce un valore di tipo HCATINFO, ma è semplicemente un typedef per HANDLE. A causa di questo, è facile usare accidentalmente HCATINFO quando si chiama una funzione che prevede un tipo diverso di HANDLE. In particolare, questo non è lo stesso di un HANDLE restituito da CryptCATOpen, anche se il compilatore non impedirà di usare HCATINFO in qualsiasi funzione che prevede un handle di catalogo.

Per acquisire un handle di catalogo da questa funzione, chiamare prima CryptCATCatalogInfoFromContext per ottenere il nome file del catalogo e quindi chiamare CryptCATOpen con tale nome file per aprire il catalogo.

Requisiti