ホーム › NetworkManagement.P2P › PeerGraphUniversalTimeToPeerTime

PeerGraphUniversalTimeToPeerTime

関数

世界協定時刻をピアグラフ時刻に変換する。

DLLP2PGRAPH.dll呼出規約winapi対応OSWindows XP 以降

シグネチャ

// P2PGRAPH.dll
#include <windows.h>

HRESULT PeerGraphUniversalTimeToPeerTime(
    void* hGraph,
    FILETIME* pftUniversalTime,
    FILETIME* pftPeerTime
);

パラメーター

名前	型	方向	説明
hGraph	void*	in	このピアが参加しているピアグラフのハンドル。このハンドルは PeerGraphCreate 関数または PeerGraphOpen 関数によって返されます。
pftUniversalTime	FILETIME*	in	FILETIME 構造体として表される汎用時刻値へのポインター。
pftPeerTime	FILETIME*	out	FILETIME 構造体として表される、返されるピア時刻 (UTC) 値へのポインター。

戻り値の型: HRESULT

公式ドキュメント

PeerGraphUniversalTimeToPeerTime 関数は、ピアのコンピューターの汎用時刻 (universal time) 値を、共通のピアグラフ時刻値に変換します。

戻り値

関数が成功した場合は S_OK を返します。それ以外の場合は、RPC エラーのいずれか、または次のいずれかの値を返します。

戻り値	説明
E_INVALIDARG	パラメーターのいずれかが有効ではありません。
PEER_E_INVALID_GRAPH	ピアグラフのハンドルが無効です。
PEER_E_NOT_INITIALIZED	この関数を使用する前に、PeerGraphStartup を呼び出してグラフを初期化しておく必要があります。

解説(Remarks)

汎用時刻 (universal time) とは、ピアのシステムクロックから導出される UTC 時刻です。

ピア時刻 (peer time) とは、ピアグラフが維持する共通の基準時刻であり、グリニッジ標準時で表されます。

レコードの作成時刻を表示する場合など、ピアのコンピューター上でこの値を表示する必要があるときは、ピア時刻を汎用時刻に変換してください。同様に、レコードの有効期限の設定や、変更時刻に基づくレコードの検索といった時刻に依存する操作では、コンピューター固有の汎用時刻からピアグラフ固有のピア時刻に変換した時刻値を使用してください。

ピア時刻は、逆方向の変換を行う関数 PeerGraphPeerTimeToUniversalTime を呼び出すことで汎用時刻に変換できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// P2PGRAPH.dll
#include <windows.h>

HRESULT PeerGraphUniversalTimeToPeerTime(
    void* hGraph,
    FILETIME* pftUniversalTime,
    FILETIME* pftPeerTime
);

[DllImport("P2PGRAPH.dll", ExactSpelling = true)]
static extern int PeerGraphUniversalTimeToPeerTime(
    IntPtr hGraph,   // void*
    IntPtr pftUniversalTime,   // FILETIME*
    IntPtr pftPeerTime   // FILETIME* out
);

<DllImport("P2PGRAPH.dll", ExactSpelling:=True)>
Public Shared Function PeerGraphUniversalTimeToPeerTime(
    hGraph As IntPtr,   ' void*
    pftUniversalTime As IntPtr,   ' FILETIME*
    pftPeerTime As IntPtr   ' FILETIME* out
) As Integer
End Function

' hGraph : void*
' pftUniversalTime : FILETIME*
' pftPeerTime : FILETIME* out
Declare PtrSafe Function PeerGraphUniversalTimeToPeerTime Lib "p2pgraph" ( _
    ByVal hGraph As LongPtr, _
    ByVal pftUniversalTime As LongPtr, _
    ByVal pftPeerTime As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

PeerGraphUniversalTimeToPeerTime = ctypes.windll.p2pgraph.PeerGraphUniversalTimeToPeerTime
PeerGraphUniversalTimeToPeerTime.restype = ctypes.c_int
PeerGraphUniversalTimeToPeerTime.argtypes = [
    ctypes.POINTER(None),  # hGraph : void*
    ctypes.c_void_p,  # pftUniversalTime : FILETIME*
    ctypes.c_void_p,  # pftPeerTime : FILETIME* out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('P2PGRAPH.dll')
PeerGraphUniversalTimeToPeerTime = Fiddle::Function.new(
  lib['PeerGraphUniversalTimeToPeerTime'],
  [
    Fiddle::TYPE_VOIDP,  # hGraph : void*
    Fiddle::TYPE_VOIDP,  # pftUniversalTime : FILETIME*
    Fiddle::TYPE_VOIDP,  # pftPeerTime : FILETIME* out
  ],
  Fiddle::TYPE_INT)

#[link(name = "p2pgraph")]
extern "system" {
    fn PeerGraphUniversalTimeToPeerTime(
        hGraph: *mut (),  // void*
        pftUniversalTime: *mut FILETIME,  // FILETIME*
        pftPeerTime: *mut FILETIME  // FILETIME* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("P2PGRAPH.dll")]
public static extern int PeerGraphUniversalTimeToPeerTime(IntPtr hGraph, IntPtr pftUniversalTime, IntPtr pftPeerTime);
"@
$api = Add-Type -MemberDefinition $sig -Name 'P2PGRAPH_PeerGraphUniversalTimeToPeerTime' -Namespace Win32 -PassThru
# $api::PeerGraphUniversalTimeToPeerTime(hGraph, pftUniversalTime, pftPeerTime)

#uselib "P2PGRAPH.dll"
#func global PeerGraphUniversalTimeToPeerTime "PeerGraphUniversalTimeToPeerTime" sptr, sptr, sptr
; PeerGraphUniversalTimeToPeerTime hGraph, varptr(pftUniversalTime), varptr(pftPeerTime)   ; 戻り値は stat
; hGraph : void* -> "sptr"
; pftUniversalTime : FILETIME* -> "sptr"
; pftPeerTime : FILETIME* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "P2PGRAPH.dll"
#cfunc global PeerGraphUniversalTimeToPeerTime "PeerGraphUniversalTimeToPeerTime" sptr, var, var
; res = PeerGraphUniversalTimeToPeerTime(hGraph, pftUniversalTime, pftPeerTime)
; hGraph : void* -> "sptr"
; pftUniversalTime : FILETIME* -> "var"
; pftPeerTime : FILETIME* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "P2PGRAPH.dll"
#cfunc global PeerGraphUniversalTimeToPeerTime "PeerGraphUniversalTimeToPeerTime" sptr, sptr, sptr
; res = PeerGraphUniversalTimeToPeerTime(hGraph, varptr(pftUniversalTime), varptr(pftPeerTime))
; hGraph : void* -> "sptr"
; pftUniversalTime : FILETIME* -> "sptr"
; pftPeerTime : FILETIME* out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。