IVsProject4.GetFilesEndingWith Method
Returns an array of ITEMIDs of the files whose name ends with the specified string. The match is case-insensitive.
Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.10.0 (in Microsoft.VisualStudio.Shell.Interop.10.0.dll)
Syntax
'Declaration
Function GetFilesEndingWith ( _
pszEndingWith As String, _
celt As UInteger, _
<OutAttribute> rgItemids As UInteger(), _
<OutAttribute> ByRef pcActual As UInteger _
) As Integer
int GetFilesEndingWith(
string pszEndingWith,
uint celt,
uint[] rgItemids,
out uint pcActual
)
int GetFilesEndingWith(
[InAttribute] String^ pszEndingWith,
[InAttribute] unsigned int celt,
[OutAttribute] array<unsigned int>^ rgItemids,
[OutAttribute] unsigned int% pcActual
)
abstract GetFilesEndingWith :
pszEndingWith:string *
celt:uint32 *
rgItemids:uint32[] byref *
pcActual:uint32 byref -> int
function GetFilesEndingWith(
pszEndingWith : String,
celt : uint,
rgItemids : uint[],
pcActual : uint
) : int
Parameters
pszEndingWith
Type: StringThe ending
celt
Type: UInt32The (requested) number of items in the array.
rgItemids
Type: array<UInt32[]The array of ITEMIDs.
pcActual
Type: UInt32%The actual number of items returned in the array.
Return Value
Type: Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
If celt is zero and rgItemids is NULL, the number of matching files is returned in pcActual. If celt is not zero, rgItemids must not be NULL, or E_POINTER is returned.
Examples
An extremely common pattern is to call the method twice, the first time passing in 0 for the number of items and NULL for the array, and the second time passing in a properly-sized array and the actual number of items, and like the following (omitting error checks for readability):
hr = pIVsProject4->GetFilesEndingWith(szEndingWith, 0, NULL, &cExpected);
VSITEMID *rgItemids = ::CoTaskMemAlloc(cExpected * sizeof(VSITEMID));
hr = pIVsProject4->GetFilesEndingWith(szEndingWith, cExpected, rgItemids, &cActual);
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.