Compartir a través de

Método IFileIsInUse::GetCapabilities (shobjidl_core.h)

  • Artículo

Determina si el archivo se puede cerrar y si la interfaz de usuario es capaz de cambiar a la ventana de la aplicación que usa el archivo.

Sintaxis

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

Parámetros

[out] pdwCapFlags

Tipo: DWORD*

Puntero a un valor que, cuando este método devuelve correctamente, recibe las marcas de funcionalidad. Uno o ambos de los valores siguientes:

OF_CAP_CANSWITCHTO (0x0001)

0x0001. La interfaz de usuario puede cambiar a la ventana de nivel superior de la aplicación que usa el archivo .

OF_CAP_CANCLOSE (0x0002)

0x0002. El archivo se puede cerrar.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Las funcionalidades devueltas por este método se pueden usar en la composición del cuadro de diálogo presentado al usuario que les informa del conflicto de uso compartido. Por ejemplo, si se recupera la marca de OF_CAP_CANSWITCHTO, se puede agregar un botón al cuadro de diálogo que cambiará al usuario a la ventana de la aplicación en conflicto (en función de la información de HWND recuperada por IFileIsInUse::GetSwitchToHWND) para que el usuario pueda abordar la situación tal como se ajuste. Si se recupera la marca OF_CAP_CANCLOSE, el cuadro de diálogo puede presentar un botón Cerrar que llame al método CloseFile .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)