IKsPropertySet::Get-Methode (ksproxy.h)

Die Get-Methode ruft eine Eigenschaft ab, die durch eine Eigenschaftensatz-GUID und einen Eigenschaftsbezeichner identifiziert wird.

Syntax

HRESULT Get(
  [in]  REFGUID PropSet,
  [in]  ULONG   Id,
  [in]  LPVOID  InstanceData,
  [in]  ULONG   InstanceLength,
  [out] LPVOID  PropertyData,
  [in]  ULONG   DataLength,
  [out] ULONG   *BytesReturned
);

Parameter

[in] PropSet

GUID, die den Eigenschaftensatz identifiziert.

[in] Id

Bezeichner der Eigenschaft innerhalb des Eigenschaftensatzes.

[in] InstanceData

Zeiger auf Instanzdaten für die Eigenschaft.

[in] InstanceLength

Größe des Puffers in Bytes bei InstanceData-.

[out] PropertyData

Zeiger auf einen Puffer, der den Wert der Eigenschaft empfängt.

[in] DataLength

Größe des Puffers in Bytes bei PropertyData-.

[out] BytesReturned

Zeigen Sie auf eine Variable, die die Größe der Daten in Byte empfängt, die Abrufen im Puffer bei PropertyData-.

Rückgabewert

Gibt NOERROR zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben.

Bemerkungen

Um eine Eigenschaft abzurufen, weisen Sie einen Puffer zu, der Abrufen Füllungen mit der Eigenschaft. Um die erforderliche Puffergröße zu ermitteln, geben Sie NULL- für PropertyData- und Null für DataLength-an. Die Get-Methode gibt die erforderliche Puffergröße in BytesReturned-zurück.

Anforderungen

Siehe auch

IKsPropertySet::Set