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

Determina se o arquivo pode ser fechado e se a interface do usuário é capaz de alternar para a janela do aplicativo que está usando o arquivo.

Sintaxe

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

Parâmetros

[out] pdwCapFlags

Tipo: DWORD*

Um ponteiro para um valor que, quando esse método retorna com êxito, recebe os sinalizadores de funcionalidade. Um ou ambos os seguintes valores:

OF_CAP_CANSWITCHTO (0x0001)

0x0001. A interface do usuário pode alternar para a janela de nível superior do aplicativo que está usando o arquivo .

OF_CAP_CANCLOSE (0x0002)

0x0002. O arquivo pode ser fechado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os recursos retornados por esse método podem ser usados na composição da caixa de diálogo apresentada ao usuário que os informa sobre o conflito de compartilhamento. Por exemplo, se o sinalizador OF_CAP_CANSWITCHTO for recuperado, um botão poderá ser adicionado à caixa de diálogo que alternará o usuário para a janela do aplicativo conflitante (com base nas informações do HWND recuperadas por IFileIsInUse::GetSwitchToHWND) para que o usuário possa resolver a situação como achar melhor. Se o sinalizador OF_CAP_CANCLOSE for recuperado, a caixa de diálogo poderá apresentar um botão Fechar que chama o método CloseFile .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)