IADsResource Property Methods
The property methods of the IADsResource interface get or set the properties described in the following table. For a general discussion of property methods, see Interface Property Methods.
Properties
-
LockCount
-
-
Access type: Read-only
-
Scripting data type: LONG
-
// C++ method syntax HRESULT get_LockCount( [out] LONG* plLockCount );
Number of locks on the resource.
-
-
Path
-
-
Access type: Read-only
-
Scripting data type: BSTR
-
// C++ method syntax HRESULT get_Path( [out] BSTR* pbstrPath );
The file system path of the opened resource.
-
-
User
-
-
Access type: Read-only
-
Scripting data type: BSTR
-
// C++ method syntax HRESULT get_User( [out] BSTR* pbstrUser );
The name of the user who opened the resource.
-
-
UserPath
-
-
Access type: Read-only
-
Scripting data type: BSTR
-
// C++ method syntax HRESULT get_UserPath( [out] BSTR* pbstrUserPath );
The ADsPath of the user object for the user who opened the resource.
-
Examples
The following code example shows how to examine open resources of a file service.
Dim fso As IADsFileServiceOperations
' Bind to a file service operations object on "myComputer" in the local domain.
Set fso = GetObject("WinNT://myComputer/LanmanServer")
' Enumerate resources.
If (IsEmpty(fso) = False) Then
For Each resource In fso.resources
MsgBox "Resource name: " & resource.name
MsgBox "Resource path: " & resource.path
Next resource
End If
Cleanup:
If (Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set fso = Nothing
The following code example enumerates a collection of resources.
IADsFileServiceOperations *pFso = NULL;
IADsResource *pRes = NULL;
IADsCollection *pColl = NULL;
IUnknown *pUnk = NULL;
IEnumVARIANT *pEnum = NULL;
BSTR bstr = NULL;
VARIANT var;
ULONG lFetch = 0;
IDispatch *pDisp = NULL;
HRESULT hr = S_OK;
LPWSTR adsPath =L"WinNT://aMachine/LanmanServer";
hr = ADsGetObject(adsPath, IID_IADsFileServiceOperations,(void**)&pFso);
if(FAILED(hr)) {goto Cleanup;}
hr = pFso->Resources(&pColl);
if(FAILED(hr)) {goto Cleanup;}
// Enumerate print jobs. Code omitted.
hr = pColl->get__NewEnum(&pUnk);
if(FAILED(hr)) {goto Cleanup;}
hr = pUnk->QueryInterface(IID_IEnumVARIANT,(void**)&pEnum);
if(FAILED(hr)) {goto Cleanup;}
// Enumerate.
VariantInit(&var);
hr = pEnum->Next(1, &var, &lFetch);
while(hr == S_OK)
{
if (lFetch == 1)
{
pDisp = V_DISPATCH(&var);
pDisp->QueryInterface(IID_IADsResource, (void**)&pRes);
pRes->get_Name(&bstr);
printf("Resource name: %S\n",bstr);
SysFreeString(bstr);
pRes->get_Path(&bstr);
printf("Resource path: %S\n",bstr);
SysFreeString(bstr);
pRes->Release();
}
pDisp->Release();
VariantClear(&var);
hr = pEnum->Next(1, &var, &lFetch);
};
Cleanup:
if(pRes) pRes->Release();
if(pDisp) pDisp->Release();
if(pEnum) pEnum->Release();
if(pUnk) pUnk->Release();
if(pColl) pColl->Release();
if(pFso) pFso->Release();
Requirements
Requirement | Value |
---|---|
Minimum supported client |
Windows Vista |
Minimum supported server |
Windows Server 2008 |
Header |
|
DLL |
|
IID |
IID_IADsResource is defined as 34A05B20-4AAB-11CF-AE2C-00AA006EBFB9 |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for