Interface IADsLargeInteger (iads.h)
L’interface IADsLargeInteger est utilisée pour manipuler des entiers 64 bits du type LargeInteger.
Héritage
L’interface IADsLargeInteger hérite de l’interface IDispatch.
Notes
La gestion des IADsLargeInteger en Visual Basic est rendue difficile par le fait que Visual Basic n’a pas de type de données numérique non signé natif. Cela peut entraîner des erreurs lors de la conversion de données si l’élément LowPart ou HighPart a le bit défini, ce qui amène Visual Basic à gérer le nombre comme négatif. Les exemples de code Visual Basic ci-dessous montrent comment gérer correctement IADsLargeInteger dans Visual Basic.
Exemples
L’exemple suivant montre comment convertir un objet IADsLargeInteger en chaîne hexadécimale.
Dim oDomain As IADs
Dim oLargeInt As LargeInteger
Set oDomain = GetObject("LDAP://DC=fabrikam,DC=com")
Set oLargeInt = oDomain.Get("creationTime")
Debug.Print oLargeInt.HighPart
Debug.Print oLargeInt.LowPart
strTemp = "&H" + CStr(Hex(oLargeInt.HighPart)) + _
CStr(Hex(oLargeInt.LowPart))
Debug.Print strTemp
En Visual Basic, il est possible de convertir des objets IADsLargeInteger qui représentent une date et/ou une heure en variant d’heure à l’aide des API FileTimeToSystemTime et SystemTimeToVariantTime . Ce cas de figure est présenté dans l’exemple de code suivant :
Public Declare Function FileTimeToSystemTime Lib "kernel32" _
(lpFileTime As FILETIME, _
lpSystemTime As SYSTEMTIME) As Long
Public Declare Function SystemTimeToVariantTime Lib "oleaut32.dll" _
(lpSystemTime As SYSTEMTIME, _
dbTime As Double) As Long
Public Type SYSTEMTIME
wYear As Integer
wMonth As Integer
wDayOfWeek As Integer
wDay As Integer
wHour As Integer
wMinute As Integer
wSecond As Integer
wMilliseconds As Integer
End Type
Public Type FILETIME
dwLowDateTime As Long
dwHighDateTime As Long
End Type
' This function will convert the ADSI data type LargeInteger to
' a Variant time value in Greenwich Mean Time (GMT).
Function LargeInteger_To_Time(oLargeInt As LargeInteger, vTime As Variant)_
As Boolean
On Error Resume Next
Dim pFileTime As FILETIME
Dim pSysTime As SYSTEMTIME
Dim dbTime As Double
Dim lResult As Long
If (oLargeInt.HighPart = 0 And oLargeInt.LowPart = 0) Then
vTime = 0
LargeInteger_To_Time = True
Exit Function
End If
If (oLargeInt.LowPart = -1) Then
vTime = -1
LargeInteger_To_Time = True
Exit Function
End If
pFileTime.dwHighDateTime = oLargeInt.HighPart
pFileTime.dwLowDateTime = oLargeInt.LowPart
' Convert the FileTime to System time.
lResult = FileTimeToSystemTime(pFileTime, pSysTime)
If lResult = 0 Then
LargeInteger_To_Time = False
Debug.Print "FileTimeToSystemTime: " + Err.Number + " - "_
+ Err.Description
Exit Function
End If
' Convert System Time to a Double.
lResult = SystemTimeToVariantTime(pSysTime, dbTime)
If lResult = 0 Then
LargeInteger_To_Time = False
Debug.Print "SystemTimeToVariantTime: " + Err.Number + _
" - " + Err.Description
Exit Function
End If
' Place the double in the variant.
vTime = CDate(dbTime)
LargeInteger_To_Time = True
End Function
L’exemple suivant montre comment convertir un IADsLargeInteger en entier 64 bits.
HRESULT PrintAccountExpires(LPCWSTR pwszADsPath)
{
if(!pwszADsPath)
{
return E_INVALIDARG;
}
HRESULT hr;
CComPtr<IADs> spads;
// Bind to the object.
hr = ADsGetObject(pwszADsPath, IID_IADs, (LPVOID*)&spads);
if(FAILED(hr))
{
return hr;
}
/*
Get the accountExpires attribute, which is an
IDispatch that contains an IADsLargeInteger.
*/
CComVariant svar;
hr = spads->Get(CComBSTR("accountExpires"), &svar);
if(FAILED(hr))
{
return hr;
}
// Get the IADsLargeInteger interface.
CComPtr<IADsLargeInteger> spli;
hr = svar.pdispVal->QueryInterface(IID_IADsLargeInteger,
(LPVOID*)&spli);
if(FAILED(hr))
{
return hr;
}
// Get the high and low parts of the value.
long lHigh;
long lLow;
hr = spli->get_HighPart(&lHigh);
hr = spli->get_LowPart(&lLow);
// Convert the high and low parts to an __i64.
__int64 i64;
i64 = (ULONG)lHigh;
i64 = (i64 << 32);
i64 = i64 + (ULONG)lLow;
// Print all of the values.
wprintf(L"HighPart = %u, LowPart = %u, Combined = %I64d\n",
lHigh, lLow, i64);
return hr;
}
Spécifications
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | iads.h |