IFhReassociation::GetConfigurationDetails-Methode (fhcfg.h)

Artikel
02/28/2024

Diese Methode listet Dateiverlaufskonfigurationen auf, die auf einem Speichergerät oder einer Netzwerkfreigabe von der IFhReassociation::ScanTargetForConfigurations-Methode ermittelt wurden, und gibt zusätzliche Informationen zu jeder ermittelten Konfiguration zurück.

Hinweis

IFhReassociation ist veraltet und kann in zukünftigen Releases geändert oder nicht mehr verfügbar sein.

Syntax

HRESULT GetConfigurationDetails(
  [in]  DWORD    Index,
  [out] BSTR     *UserName,
  [out] BSTR     *PcName,
  [out] FILETIME *BackupTime
);

Parameter

[in] Index

Nullbasierter Index einer ermittelten Konfiguration.

[out] UserName

Enthält bei der Rückgabe einen Zeiger auf eine Zeichenfolge, die SysAllocString zugeordnet ist, die den Namen des Benutzerkontos enthält, unter dem die Konfiguration zuletzt gesichert wurde.

[out] PcName

Enthält bei der Rückgabe einen Zeiger auf eine Zeichenfolge, die SysAllocString zugeordnet ist und den Namen des Computers enthält, von dem die Konfiguration zuletzt gesichert wurde.

[out] BackupTime

Enthält bei der Rückgabe das Datum und die Uhrzeit, zu dem die Konfiguration zuletzt gesichert wurde.

Rückgabewert

S_OK bei Erfolg oder einem erfolglosen HRESULT bei Einem Fehler. Mögliche nicht erfolgreiche HRESULT-Werte umfassen Werte, die in der Headerdatei "FhErrors.h" definiert sind.

Wenn keine Dateiverlaufskonfiguration mit dem angegebenen Index vorhanden ist, wird der HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Fehlercode zurückgegeben.

Hinweise

Der Aufrufer ist dafür verantwortlich, den für UserName und PcName zugewiesenen Arbeitsspeicher freizugeben, indem SysFreeString für jeden von ihnen aufgerufen wird.

Um eine erneute Zuordnung durchzuführen, muss eine der von dieser Methode aufgelisteten Konfigurationen mithilfe der IFhReassociation::SelectConfiguration-Methode ausgewählt werden, und dann muss die IFhReassociation::P erformReassociation-Methode aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	fhcfg.h