Compartir a través de

Método IMFSensorDevice::GetSymbolicLink (mfidl.h)

  • Artículo

Obtiene el nombre del vínculo simbólico del dispositivo sensor.

Sintaxis

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

Parámetros

[out] SymbolicLink

Búfer de caracteres cchSymbolicLink donde se escribirá el nombre del vínculo simbólico. El búfer debe ser lo suficientemente grande como para tener en cuenta el terminador null.

[in] cchSymbolicLink

Número de caracteres disponibles en el búfer de SymbolicLink .

[out] pcchWritten

Parámetro de salida que contiene el número de caracteres escritos en SymbolicLink. Esto incluye el terminador nulo. Si SymbolicLink es null y cchSymbolicLink es 0, pcchWritten contendrá el número de caracteres necesarios (incluido el terminador nulo) para almacenar el nombre del vínculo simbólico.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
ERROR_INSUFFICIENT_BUFFER
 El búfer proporcionado en el parámetro SymbolicLink no es lo suficientemente grande como para contener el nombre del vínculo simbólico, incluido el terminador NULL.
MF_E_NOT_INITIALIZED
 El dispositivo del sensor no se ha inicializado.

Comentarios

Según el tipo de dispositivo, definido por un miembro de la enumeración MFSensorDeviceType y se puede obtener llamando a GetDeviceType, el nombre simbólico resultante puede ser un nombre simbólico de dispositivo válido o una dirección URL del proveedor. El autor de la llamada no debe intentar analizar el nombre y debe tratarlo como datos opacos.

Requisitos

   
Cliente mínimo compatible Windows 10, versión 1607 [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfplat.lib; Mfplat.dll

Consulte también

IMFSensorDevice