CertStoreProvFindCTL-Rückruffunktion
Die Rückruffunktion CertStoreProvFindCTL listet die erste oder nächste CTL in einem externen Speicher auf oder sucht sie.
Syntax
BOOL WINAPI CertStoreProvFindCTL(
_In_ HCERTSTOREPROV hStoreProv,
_In_ PCCERT_STORE_PROV_FIND_INFO pFindInfo,
_In_ PCCTL_CONTEXT pPrevCtlContext,
_In_ DWORD dwFlags,
_Inout_ void **ppvStoreProvFindInfo,
_Out_ PCCTL_CONTEXT *ppProvCtlContext
);
Parameter
-
hStoreProv [in]
-
HCERTSTOREPROV-Handle für einen Zertifikatspeicher.
-
pFindInfo [in]
-
Ein Zeiger auf eine CERT_STORE_PROV_FIND_INFO-Struktur , die alle An certFindCTLInStore übergebenen Parameter enthält. Funktion zurückgegeben wird.
-
pPrevCtlContext [in]
-
Ein Zeiger auf eine CTL_CONTEXT Struktur der letzten gefundenen CTL. Beim ersten Aufruf der Funktion sollte dieser Parameter auf NULL festgelegt werden. Bei nachfolgenden Aufrufen sollte er auf den Zeiger festgelegt werden, der im ppProvCTLContext-Parameter beim letzten Aufruf zurückgegeben wurde. Ein nicht NULL-Zeiger , der in diesem Parameter übergeben wird, wird von der Rückruffunktion freigegeben.
-
dwFlags [in]
-
Alle erforderlichen Flagwerte.
-
ppvStoreProvFindInfo [in, out]
-
Ein Zeiger auf einen Zeiger auf den Puffer, um die Informationen des Speicheranbieters zurückzugeben. Optional kann der Rückruf einen Zeiger auf interne Suchinformationen in diesem Parameter zurückgeben. Nach dem ersten Aufruf wird dieser Parameter auf den Zeiger festgelegt, der vom vorherigen Aufruf der Funktion zurückgegeben wurde.
-
ppProvCtlContext [out]
-
Bei einer erfolgreichen Suche wird in diesem Parameter ein Zeiger auf die gefundene CTL zurückgegeben.
Rückgabewert
Gibt TRUE zurück, wenn die Funktion erfolgreich ist, oder FALSE , wenn sie fehlschlägt.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
Weitere Informationen