IWMDMOperation::GetObjectAttributes-Methode (mswmdm.h)

Artikel
03/04/2024

Mit der GetObjectAttributes-Methode kann die Anwendung Attribute für ein Objekt angeben, das auf ein Gerät geschrieben wird. Windows Media Geräte-Manager ruft diese Methode auf, bevor eine Datei auf das Gerät geschrieben wird, um die Attribute der Datei zu lernen.

Syntax

HRESULT GetObjectAttributes(
  [out] DWORD         *pdwAttributes,
  [out] _WAVEFORMATEX *pFormat
);

Parameter

[out] pdwAttributes

Zeiger auf ein DWORD , das die in der IWMDMStorage::GetAttributes-Methode definierten Attribute angibt.

[out] pFormat

Zeiger auf eine _WAVEFORMATEX-Struktur , die das Audioformat für Dateien mit Audiodatenattributen angibt.

Rückgabewert

Die Anwendung sollte einen der folgenden HRESULT-Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Lesevorgang sollte fortgesetzt werden.
WMDM_E_USER_CANCELLED	Der Lesevorgang sollte ohne Abschluss abgebrochen werden.
E_FAIL	Ein nicht angegebener Fehler ist aufgetreten, und der Lesevorgang sollte abgebrochen werden, ohne abgeschlossen zu sein.

Hinweise

Beim Übertragen von Daten auf das Gerät sollten Sie Objektattribute für eine optimale Übertragung angeben.

Beispiele

Der folgende C++-Code implementiert die GetObjectAttributes-Methode . Es wird versucht, zu ermitteln, ob es sich bei der zu lesenden Datei (m_File) um eine Datei oder einen Ordner handelt, und die zurückgegebenen Attribute entsprechend festgelegt.


HRESULT GetObjectAttributes(DWORD* pdwAttributes, _WAVEFORMATEX* pFormat)
{
    // TODO: Display the message: IWMDMOperation event--GetObjectAttributes.
    *pdwAttributes = WMDM_FILE_ATTR_FILE | 
        WMDM_STORAGE_ATTR_REMOVABLE | 
        WMDM_FILE_ATTR_AUDIO;

    BY_HANDLE_FILE_INFORMATION fileInformation;
    if (GetFileInformationByHandle(m_File, &fileInformation))
    {
        if (fileInformation.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)
            *pdwAttributes |= WMDM_FILE_ATTR_FOLDER;
        else
            *pdwAttributes |= WMDM_FILE_ATTR_FILE;

        if (fileInformation.dwFileAttributes & FILE_ATTRIBUTE_READONLY)
            *pdwAttributes |= FILE_ATTRIBUTE_READONLY;
    }

    return S_OK;
}