Provides write access to the repository that it is associated with and manages one or more IRepositoryRecordInserterLight interfaces, which do the actual writing. For each IRepositoryRecordInserterLight, it also stores predefined field values that are the same in all records written by that IRepositoryRecordInserterLight.
Incoming records are pushed to the repository at regular intervals. However, you can force an immediate write by calling the Commit method.
Sets the values of the path-specifying fields for records that will be written to the same repository file.
HRESULT BindFields(
[in] tags path,
[out, retval] IRepositoryRecordInserterLight**
);
Name | Type | Meaning |
---|---|---|
path |
The field record values that you specify here are supposed to be the same for all records generated by the IRepositoryRecordInserterLight that will be initialized. | |
|
Record-inserting interface with some record field values predefined. |
Writes the specified records to the repository asynchronously.
HRESULT PutRecords(
[in] SAFEARRAY(struct record) records
);
Name | Type | Meaning |
---|---|---|
records |
SAFEARRAY(struct record) |
Records to put in the repository. |
Writes the specified records to the repository asynchronously. This method is similar to PutRecords, except the type of the input parameter. Using the IBulkRecord interface for input makes it possible to write event records converted by IEventToRecordFormatter. For details, see Event Record Data Structures.
HRESULT PutRecords2(
[in] IBulkRecord* pBulkRecord
);
Name | Type | Meaning |
---|---|---|
records |
IBulkRecord* pBulkRecord |
Records (normally, converted from events) to put in the repository. |
Performs all deferred record writes synchronously.
|
Caution: This operation is resource-intensive and should not be used needlessly. For example, committing after each record is strongly discouraged. InTrust commits records automatically every 60 seconds. Forcing a commit is acceptable in situations like the following:
|
HRESULT Commit();
Name |
Value |
Meaning |
---|---|---|
ITRT_E_COMMIT_TO_INTERMEDIATE_STORE_FAILED |
0x8ADD1002 |
Cannot commit records to intermediate store on InTrust server. |
ITRT_E_COMMIT_TO_REPOSITORY_FAILED |
0x8ADD1003 |
Cannot commit records to repository. |
ITRT_E_COMMIT_IN_PROGRESS |
0x8ADD1004 |
Commit is still in progress. |
Provides write access to the repository that it is associated with and manages one or more IRepositoryRecordInserterLight interfaces, which do the actual writing. For each IRepositoryRecordInserterLight, it also stores predefined field values that are the same in all records written by that IRepositoryRecordInserterLight.
Incoming records are pushed to the repository at regular intervals. However, you can force an immediate write by calling the Commit method.
Sets the values of the path-specifying fields for records that will be written to the same repository file.
HRESULT BindFields(
[in] tags path,
[out, retval] IRepositoryRecordInserterLight**
);
Name | Type | Meaning |
---|---|---|
path |
The field record values that you specify here are supposed to be the same for all records generated by the IRepositoryRecordInserterLight that will be initialized. | |
|
Record-inserting interface with some record field values predefined. |
Writes the specified records to the repository asynchronously.
HRESULT PutRecords(
[in] SAFEARRAY(struct record) records
);
Name | Type | Meaning |
---|---|---|
records |
SAFEARRAY(struct record) |
Records to put in the repository. |
Writes the specified records to the repository asynchronously. This method is similar to PutRecords, except the type of the input parameter. Using the IBulkRecord interface for input makes it possible to write event records converted by IEventToRecordFormatter. For details, see Event Record Data Structures.
HRESULT PutRecords2(
[in] IBulkRecord* pBulkRecord
);
Name | Type | Meaning |
---|---|---|
records |
IBulkRecord* pBulkRecord |
Records (normally, converted from events) to put in the repository. |
Performs all deferred record writes synchronously.
|
Caution: This operation is resource-intensive and should not be used needlessly. For example, committing after each record is strongly discouraged. InTrust commits records automatically every 60 seconds. Forcing a commit is acceptable in situations like the following:
|
HRESULT Commit();
Name |
Value |
Meaning |
---|---|---|
ITRT_E_COMMIT_TO_INTERMEDIATE_STORE_FAILED |
0x8ADD1002 |
Cannot commit records to intermediate store on InTrust server. |
ITRT_E_COMMIT_TO_REPOSITORY_FAILED |
0x8ADD1003 |
Cannot commit records to repository. |
ITRT_E_COMMIT_IN_PROGRESS |
0x8ADD1004 |
Commit is still in progress. |
Performs deferred record writes. This method either submits records to a queue on the server or puts them directly in the repository, depending on the argument. Using RepositoryCommitType::ToRepositoryRepositoryCommitType as the argument is equivalent to calling the Commit method.
|
Caution: Direct writes to the repository are resource-intensive and should not be used needlessly. For example, committing after each record is strongly discouraged. InTrust commits records automatically every 60 seconds. Forcing a commit is acceptable in situations like the following:
|
HRESULT Commit2(
[in, defaultvalue(ToRepositoryRepositoryCommitType)] RepositoryCommitType commitType
);
Name | Type | Meaning |
---|---|---|
commitType |
Whether to queue the committed records on the server or put them directly in the repository. |
Name |
Value |
Meaning |
---|---|---|
ITRT_E_COMMIT_TO_INTERMEDIATE_STORE_FAILED |
0x8ADD1002 |
Cannot commit records to intermediate store on InTrust server. |
ITRT_E_COMMIT_TO_REPOSITORY_FAILED |
0x8ADD1003 |
Cannot commit records to repository. |
ITRT_E_COMMIT_IN_PROGRESS |
0x8ADD1004 |
Commit is still in progress. |
Generates valid record structures from predefined and significant values and writes them to the repository.
|
Note:IRepositoryRecordInserterLight or IRepositoryRecordInserter: when to use which? Use IRepositoryRecordInserterLight if you need to write large numbers of records with coinciding values in specific fields. Otherwise, using IRepositoryRecordInserter should be more efficient. |
HRESULT PutRecords(
[in] SAFEARRAY(struct contents) recordFields
);
Name | Type | Meaning |
---|---|---|
recordFields |
SAFEARRAY(struct contents) |
Field value structures to convert to records. Missing fields will be filled in based on the tags structure instance associated with this IRepositoryRecordInserterLight. |
Represents a script used in InTrust operations.
Returns the description of the script.
HRESULT Description(
[out, retval] BSTR* description
);
Name | Type | Meaning |
---|---|---|
description |
BSTR* |
Description of the script. |
Sets the description of the script.
HRESULT Description(
[in] BSTR description
);
Name | Type | Meaning |
---|---|---|
description |
BSTR |
Description of the script. |
Returns the ID of the script.
HRESULT ID(
[out, retval] BSTR* pID
);
Name | Type | Meaning |
---|---|---|
pID |
BSTR* |
ID of the script. |
Returns which language the script is in.
HRESULT Language(
[out, retval] enum ScriptLanguage* language
);
Name | Type | Meaning |
---|---|---|
language |
enum ScriptLanguage* |
Which language the script is in. |
Sets which language the script is in.
HRESULT Language(
[in] enum ScriptLanguage language
);
Name | Type | Meaning |
---|---|---|
language |
enum ScriptLanguage |
Which language the script is in. |
Returns the name of the script.
HRESULT Name(
[out, retval] BSTR *name
);
Name | Type | Meaning |
---|---|---|
name |
BSTR* |
Name of the script. |
Sets the name of the script.
HRESULT Name(
[in] BSTR name
);
Name | Type | Meaning |
---|---|---|
name |
BSTR |
Name of the script. |
Provides access to a collection of the script's parameters.
HRESULT Parameters(
[out, retval] IScriptParameterCollection** ppParameters
);
Name | Type | Meaning |
---|---|---|
ppParameters |
Collection of the script's parameters. |
Returns the script source code.
HRESULT Script(
[out, retval] BSTR* script
);
Name | Type | Meaning |
---|---|---|
script |
BSTR* |
Script source code. |
Overwrites the script source code.
HRESULT Script(
[in] BSTR script
);
Name | Type | Meaning |
---|---|---|
script |
BSTR |
Script source code. |
© ALL RIGHTS RESERVED. Conditions d’utilisation Confidentialité Cookie Preference Center