Metodo IEnumConnections::Next (ocidl.h)

Articolo
02/29/2024

Recupera il numero specificato di elementi nella sequenza di enumerazione.

Sintassi

HRESULT Next(
  [in]  ULONG         cConnections,
  [out] LPCONNECTDATA rgcd,
  [out] ULONG         *pcFetched
);

Parametri

[in] cConnections

Numero di elementi da recuperare. Se nella sequenza sono presenti meno elementi richiesti, questo metodo recupera gli elementi rimanenti.

[out] rgcd

Matrice di elementi enumerati.

L'enumeratore è responsabile dell'allocazione di qualsiasi memoria e il chiamante è responsabile della liberazione. Se celt è maggiore di 1, il chiamante deve anche passare un puntatore non NULL passato a pceltFetched per sapere quanti puntatori rilasciare.

[out] pcFetched

Numero di elementi recuperati. Questo parametro è sempre minore o uguale al numero di elementi richiesti.

Valore restituito

Se il metodo recupera il numero di elementi richiesti, il valore restituito è S_OK. In caso contrario, è S_FALSE.

Commenti

Dopo che questo metodo restituisce correttamente, il chiamante è responsabile della chiamata a Release (vedere il membro pUnk di CONNECTDATA) per ogni elemento della matrice. Se cConnections è maggiore di uno, il chiamante deve anche passare un puntatore non NULL a lpcFetched per ottenere il numero di puntatori che deve essere rilasciato.

E_NOTIMPL non è consentito come valore restituito. Se viene restituito un valore di errore, nessuna voce nella matrice è valida all'uscita e pertanto non è necessaria alcuna versione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h (include ObjIdl.h)

Vedi anche

CONNECTDATA

Ienumconnections

Condividi tramite