Metodo IFileIsInUse::GetCapabilities (shobjidl_core.h)

Determina se il file può essere chiuso e se l'interfaccia utente è in grado di passare alla finestra dell'applicazione che usa il file.

Sintassi

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

Parametri

[out] pdwCapFlags

Tipo: DWORD*

Puntatore a un valore che, quando il metodo viene restituito correttamente, riceve i flag di funzionalità. Uno o entrambi i valori seguenti:

OF_CAP_CANSWITCHTO (0x0001)

0x0001. L'interfaccia utente può passare alla finestra di primo livello dell'applicazione che usa il file.

OF_CAP_CANCLOSE (0x0002)

0x0002. Il file può essere chiuso.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Le funzionalità restituite da questo metodo possono essere utilizzate nella composizione della finestra di dialogo presentata all'utente che li informa del conflitto di condivisione. Ad esempio, se il flag OF_CAP_CANSWITCHTO viene recuperato, è possibile aggiungere un pulsante alla finestra di dialogo che passerà all'utente alla finestra dell'applicazione in conflitto (in base alle informazioni HWND recuperate da IFileIsInUse::GetSwitchToHWND) in modo che l'utente possa risolvere la situazione nel modo desiderato. Se il flag OF_CAP_CANCLOSE viene recuperato, la finestra di dialogo può presentare un pulsante Close che chiama il metodo CloseFile .

Requisiti