PeerGraphPeerTimeToUniversalTime-Funktion (p2p.h)
Die PeerGraphPeerTimeToUniversalTime-Funktion konvertiert den Peergraph-verwalteten Referenzzeitwert in einen lokalisierten Zeitwert, der für die Anzeige auf dem Computer des Peers geeignet ist.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphPeerTimeToUniversalTime(
[in] HGRAPH hGraph,
[in] FILETIME *pftPeerTime,
[out] FILETIME *pftUniversalTime
);
Parameter
[in] hGraph
Behandeln Sie das Peerdiagramm, an dem dieser Peer teilnimmt. Dieses Handle wird von der PeerGraphCreate- oder PeerGraphOpen-Funktion zurückgegeben.
[in] pftPeerTime
Zeiger auf den Wert der Peerzeit (UTC), der als FILETIME-Struktur dargestellt wird.
[out] pftUniversalTime
Zeiger auf den zurückgegebenen universellen Zeitwert, der als FILETIME-Struktur dargestellt wird.
Rückgabewert
Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Das Handle für das Diagramm ist ungültig. |
|
Das Diagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird. |
Hinweise
Universalzeit ist die UTC-Zeit, die von der Systemuhr des Peers abgeleitet wird.
Peerzeit ist eine allgemeine Referenzzeit, die vom Peerdiagramm verwaltet wird, ausgedrückt als Greenwich Mean Time.
Die Peerzeit sollte immer dann in universelle Zeit umgewandelt werden, wenn dieser Wert auf dem Computer des Peers angezeigt werden muss, z. B. beim Anzeigen der Erstellungszeit eines Datensatzes. Ebenso sollten zeitabhängige Aktionen, z. B. das Festlegen der Ablaufzeit für einen Datensatz oder die Suche nach Datensätzen basierend auf der Änderungszeit, Zeitwerte verwenden, die von der computerspezifischen Universalzeit in graphspezifische Peerzeit konvertiert werden.
Universelle Zeit kann durch Aufrufen der umgekehrten Funktion PeerGraphUniversalTimeToPeerTime in Peerzeit konvertiert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2PGraph.lib |
| DLL | P2PGraph.dll |