NetRemoteTOD-Funktion (lmremutl.h)

Die NetRemoteTOD-Funktion gibt die Tageszeitinformationen von einem angegebenen Server zurück.

Syntax

NET_API_STATUS NET_API_FUNCTION NetRemoteTOD(
  [in]  LPCWSTR UncServerName,
  [out] LPBYTE  *BufferPtr
);

Parameter

[in] UncServerName

Zeiger auf eine konstante Zeichenfolge, die den DNS- oder NetBIOS-Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[out] BufferPtr

Zeiger auf die Adresse, die die TIME_OF_DAY_INFO Informationsstruktur empfängt. Dieser Puffer wird vom System zugewiesen und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Für die erfolgreiche Ausführung der NetRemoteTOD-Funktion ist keine spezielle Gruppenmitgliedschaft erforderlich.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das aktuelle Datum und die aktuelle Uhrzeit mit einem Aufruf der NetRemoteTOD-Funktion abrufen und drucken. Hierzu verwendet das Beispiel die TIME_OF_DAY_INFO-Struktur . Schließlich gibt das Beispiel den für den Informationspuffer zugewiesenen Arbeitsspeicher frei.

#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;
}

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmremutl.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

Remote-Hilfsprogrammfunktionen

TIME_OF_DAY_INFO