Share via

IMFSensorGroup::GetSymbolicLink-Methode (mfidl.h)

  • Artikel

Ruft den symbolischen Linknamen der Sensorgruppe ab.

Syntax

HRESULT GetSymbolicLink(
  [out] LPWSTR SymbolicLink,
  [in]  LONG   cchSymbolicLink,
  [out] LONG   *pcchWritten
);

Parameter

[out] SymbolicLink

Puffer von cchSymbolicLink-Zeichen , in die der symbolische Linkname geschrieben wird. Der Puffer muss groß genug sein, um den NULL-Abschlusszeichen zu berücksichtigen.

[in] cchSymbolicLink

Anzahl der im SymbolicLink-Puffer verfügbaren Zeichen.

[out] pcchWritten

Ausgabeparameter, der die Anzahl der in SymbolicLink geschriebenen Zeichen enthält. Dies schließt den NULL-Abschlusszeichen ein. Wenn SymbolicLink NULL und cchSymbolicLink den Wert 0 aufweist, enthält pcchWritten die Anzahl der Zeichen, die zum Speichern des symbolischen Linknamens erforderlich sind (einschließlich des NULL-Abschlusszeichens).

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
ERROR_INSUFFICIENT_BUFFER
 Der im SymbolicLink-Parameter bereitgestellte Puffer ist nicht groß genug, um den namen der symbolischen Verknüpfung, einschließlich des NULL-Abschlusszeichens, zu enthalten.
MF_E_NOT_INITIALIZED
 Die Sensorgruppe wurde nicht initialisiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfplat.lib; Mfplat.dll

Weitere Informationen

IMFSensorGroup