The property methods of the IADsFileService interface get or set the properties described in the following table. For more information, see Interface Property Methods.
Properties
Description
The description of the file service.
Access type: Read/write
Scripting data type: BSTR
// C++ method syntax
HRESULT get_Description(
[out] BSTR* pbstrDescription
);
HRESULT put_Description(
[in] BSTR bstrDescription
);
MaxUserCount
The maximum number of users allowed on the service at any time.
Access type: Read/write
Scripting data type: LONG
// C++ method syntax
HRESULT get_MaxUserCount(
[out] LONG* plMaxUserCount
);
HRESULT put_MaxUserCount(
[in] LONG lMaxUserCount
);
Remarks
You must go through the file service to access file shares, sessions, and resources on a computer.
Examples
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;
}
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Header | Iads.h |
| DLL | Activeds.dll |
| IID | IID_IADsFileService is defined as A89D1900-31CA-11CF-A98A-00AA006BC149 |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
