NetRemoteTOD 函数 (lmremutl.h)
NetRemoteTOD 函数从指定服务器返回一天中的时间信息。
语法
NET_API_STATUS NET_API_FUNCTION NetRemoteTOD(
[in] LPCWSTR UncServerName,
[out] LPBYTE *BufferPtr
);
parameters
[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) |
| Library | Netapi32.lib |
| DLL | Netapi32.dll |