Méthode IMFSensorGroup ::GetSymbolicLink (mfidl.h)

Article
03/04/2024

Obtient le nom de lien symbolique du groupe de capteurs.

Syntaxe

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

Paramètres

[out] SymbolicLink

Mémoire tampon des caractères cchSymbolicLink où le nom de lien symbolique sera écrit. La mémoire tampon doit être suffisamment grande pour prendre en compte la fin null.

[in] cchSymbolicLink

Nombre de caractères disponibles dans la mémoire tampon SymbolicLink .

[out] pcchWritten

Paramètre de sortie contenant le nombre de caractères écrits dans SymbolicLink. Cela inclut le terminateur null. Si SymbolicLink a la valeur null et que cchSymbolicLink a la valeur 0, pcchWritten contiendra le nombre de caractères nécessaires (y compris la fin null) pour stocker le nom du lien symbolique.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon fournie dans le paramètre SymbolicLink n’est pas assez grande pour contenir le nom du lien symbolique, y compris la terminaison null.
MF_E_NOT_INITIALIZED	Le groupe de capteurs n’a pas été initialisé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mfplat.lib ; Mfplat.dll

Voir aussi

IMFSensorGroup

Partager via