IMFSensorGroup::GetSymbolicLink-Methode (mfidl.h)

Artikel
08/24/2023

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

Freigeben über