Windows API一日一練(71)GetComputerName函數

  Windows API一日一練(71)GetComputerName函數

當你在一個大公司裡面，當一個網路系統管理員時，發現成千上萬個電腦需要你去管理時，怎麼去區分這些電腦呢？那肯定是通過電腦的名稱。而這個網路系統管理員又需要你開發一套軟體，它可以把所有電腦的名稱自動地上報給他。面對這樣的需求，就可以使用下面的函數GetComputerName來擷取電腦的名稱，並通過網路傳送給管理員。

函數GetComputerName聲明如下：

WINBASEAPI
BOOL
WINAPI
GetComputerNameA (
    __out_ecount_part(*nSize, *nSize + 1) LPSTR lpBuffer,
    __inout LPDWORD nSize
    );
WINBASEAPI
BOOL
WINAPI
GetComputerNameW (
    __out_ecount_part(*nSize, *nSize + 1) LPWSTR lpBuffer,
    __inout LPDWORD nSize
    );
#ifdef UNICODE
#define GetComputerName GetComputerNameW
#else
#define GetComputerName GetComputerNameA
#endif // !UNICODE

lpBuffer是擷取電腦名稱的緩衝區。
nSize是輸入緩衝區的大小和輸出電腦名稱的大小。

調用函數的例子如下：
#001 //
#002  //擷取當前電腦的名稱。
#003  //蔡軍生 2007/11/12 QQ:9073204 深圳
#004  void GetPCName(void)
#005  {
#006        //
#007        const int nBufSize = MAX_COMPUTERNAME_LENGTH + 1;
#008        TCHAR chBuf[nBufSize];
#009        ZeroMemory(chBuf,nBufSize);
#010
#011        //擷取當前電腦的名稱
#012        DWORD dwRet = nBufSize;
#013        if (GetComputerName(chBuf,&dwRet))
#014        {
#015              //
#016              OutputDebugString(chBuf);               
#017        }
#018        else
#019        {
#020              OutputDebugString(_T("擷取計算名稱出錯!"));             
#021        }
#022
#023        OutputDebugString(_T("/r/n"));
#024
#025  }