NetRemoteTOD 函式 (lmremutl.h)
NetRemoteTOD函式會從指定的伺服器傳回當日資訊的時間。
語法
NET_API_STATUS NET_API_FUNCTION NetRemoteTOD(
[in] LPCWSTR UncServerName,
[out] LPBYTE *BufferPtr
);
參數
[in] UncServerName
常數位符串的指標，指定函式執行所在遠端伺服器的 DNS 或 NetBIOS 名稱。 如果此參數為 Null，則會使用本機電腦。
[out] BufferPtr
接收 TIME_OF_DAY_INFO 資訊結構的位址指標。 此緩衝區是由系統所配置，必須使用 NetApiBufferFree 函式釋放。
傳回值
如果函式成功，傳回值會NERR_Success。
如果函式失敗，則傳回值是系統錯誤碼。 如需錯誤碼的清單，請參閱 系統錯誤碼。
備註
成功執行 NetRemoteTOD 函式不需要特殊群組成員資格。
範例
下列程式碼範例示範如何使用 對 NetRemoteTOD 函式的呼叫來擷取和列印目前的日期和時間。 若要這樣做，此範例會使用 TIME_OF_DAY_INFO 結構。 最後，此範例會釋放配置給資訊緩衝區的記憶體。
#include <stdio.h>
#include <windows.h>
#include <lm.h>
#pragma comment(lib, "netapi32.lib")
#ifndef UNICODE
#define UNICODE
#endif
int wmain(int argc, wchar_t *argv[])
{
LPTIME_OF_DAY_INFO pBuf = NULL;
NET_API_STATUS nStatus;
LPTSTR pszServerName = NULL;
if (argc > 2)
{
fwprintf(stderr, L"Usage: %s [\\\\ServerName]\n", argv[0]);
exit(1);
}
// The server is not the default local computer.
//
if (argc == 2)
pszServerName = (LPTSTR) argv[1];
//
// Call the NetRemoteTOD function.
//
nStatus = NetRemoteTOD((LPCWSTR) pszServerName,
(LPBYTE *)&pBuf);
//
// If the function succeeds, display the current date and time.
//
if (nStatus == NERR_Success)
{
if (pBuf != NULL)
{
fprintf(stderr, "\nThe current date is: %d/%d/%d\n",
pBuf->tod_month, pBuf->tod_day, pBuf->tod_year);
fprintf(stderr, "The current time is: %d:%d:%d\n",
pBuf->tod_hours, pBuf->tod_mins, pBuf->tod_secs);
}
}
//
// Otherwise, display a system error.
else
fprintf(stderr, "A system error has occurred: %d\n", nStatus);
//
// Free the allocated buffer.
//
if (pBuf != NULL)
NetApiBufferFree(pBuf);
return 0;
}
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | lmremutl.h (包含 Lm.h) |
| 程式庫 | Netapi32.lib |
| Dll | Netapi32.dll |