IADsFileService Property Methods
The property methods of the IADsFileService interface get or set the properties described in the following table. For more information, see Interface Property Methods.
-
Description
-
-
Access type: Read/write
-
Scripting data type: BSTR
-
// C++ method syntax HRESULT get_Description( [out] BSTR* pbstrDescription ); HRESULT put_Description( [in] BSTR bstrDescription );
The description of the file service.
-
-
MaxUserCount
-
-
Access type: Read/write
-
Scripting data type: LONG
-
// C++ method syntax HRESULT get_MaxUserCount( [out] LONG* plMaxUserCount ); HRESULT put_MaxUserCount( [in] LONG lMaxUserCount );
The maximum number of users allowed on the service at any time.
-
You must go through the file service to access file shares, sessions, and resources on a computer.
The following code example writes a description for and check the user limit of the file service.
Dim fs As IADsFileService
On Error GoTo Cleanup
' Bind to a file service object on "myComputer" in the local domain.
Set fs = GetObject("WinNT://myComputer/LanmanServer")
fs.Description = "WinNT file service."
n = fs.MaxUserCount
If n = -1 Then
MsgBox "No limit has been imposed on number of users allowed."
Else
MsgBox n & " users are allowed."
End If
Cleanup:
If (Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set fs = Nothing
The following code example writes a description for and check the user limit on a file service object.
HRESULT CheckFileService()
{
IADsFileService *pFs = NULL;
LPWSTR adsPath = L"WinNT://myComputer/LanmanServer";
HRESULT hr = S_OK;
long count = 0;
hr = ADsGetObject(adsPath, IID_IADsFileService, (void**)&pFs)
if(FAILED(hr)) {goto Cleanup;}
hr = pFs->put_Description(CComBSTR("WinNT File Service"));
if(FAILED(hr)) {goto Cleanup;}
hr = pFs->SetInfo();
if(FAILED(hr)) {goto Cleanup;}
hr = pFs->get_MaxUserCount(&count);
if(FAILED(hr)) {goto Cleanup;}
if(count == -1) {
printf("No limit has been imposed on the number of users.\n");
}
else {
printf("Number of allowed users are %d\n",count);
}
Cleanup:
if(pFs) pFs->Release();
return S_OK;
}
Requirement | Value |
---|---|
Minimum supported client |
Windows Vista |
Minimum supported server |
Windows Server 2008 |
Header |
|
DLL |
|
IID |
IID_IADsFileService is defined as A89D1900-31CA-11CF-A98A-00AA006BC149 |