PropKeyFindKeyGetNthUlong-Funktion (sensorsutils.h)

Diese Routine ruft den n. ULONG-Wert aus einem PROPVARIANT innerhalb einer Auflistungsliste ab, die auf PROPERTYKEY basiert.

Syntax

NTSTATUS PropKeyFindKeyGetNthUlong(
  [in]  const SENSOR_COLLECTION_LIST *pList,
  [in]  const PROPERTYKEY            *pKey,
  [in]  const UINT32                 Occurrence,
  [out] ULONG                        *pRetValue
);

Parameter

[in] pList

Zeiger auf die Liste der PROPVARIANT-Auflistung.

[in] pKey

Zeiger auf einen PROPERTYKEY für das PROPVARIANT-Ziel.

[in] Occurrence

Nullbasierte Anzahl von Vorkommen, der PROPERTYKEY muss gefunden werden, bevor der Wert zurückgegeben wird.

[out] pRetValue

Zeiger auf den Ausgabepuffer.

Rückgabewert

Diese Funktion gibt einen der folgenden NTSTATUS-Codes zurück:

• STATUS_INVALID_PARAMETER, wenn pList, pKey oder pRetValue nullptr ist.
• STATUS_NOT_FOUND, wenn das Element unter "Vorkommen" nicht gefunden wurde.
• STATUS_SUCCESS auf Erfolg.

Anforderungen