Sam: Created page with "This retrieves the status of the investigation. It corresponds to the `[InvestigationStatusID]` column of the `[Investigation]` table. It should contain..."

2021-02-18T15:47:30Z

Created page with "This retrieves the status of the investigation. It corresponds to the <code>[InvestigationStatusID]</code> column of the <code>[Investigation]</code> table. It should contain..."

New page

This retrieves the status of the investigation.
It corresponds to the <code>[InvestigationStatusID]</code> column of the <code>[Investigation]</code> table.
It should contain a value from the <code>[ID]</code> column of the <code>[InvestigationStatus]</code> table.

=Syntax=
<source lang="C">
uint64_t truxton_investigation_get_status( uint64_t investigation_handle );
</source>

=Parameters=
==<code>investigation_handle</code>==
The handle created by the [[truxton_investigation_create|truxton_investigation_create()]].

=Return value=
The identifier of the jurisdiction.

=Sample=
<source lang="C" highlight="21">
void dump( uint64_t investigation_handle )
{
uint64_t integer_value = 0;
char string_value[ 256 ];

truxton_investigation_get_id( investigation_handle, string_value, sizeof( string_value ) ) ;
printf( "ID: %s\n", string_value );

truxton_investigation_get_name( investigation_handle, string_value, sizeof( string_value ) );
printf( "Name: %s\n", string_value );

truxton_investigation_get_description( investigation_handle, string_value, sizeof( string_value ) );
printf( "Description: %s\n", string_value );

truxton_investigation_get_case_number( investigation_handle, string_value, sizeof( string_value ) );
printf( "Case: %s\n", string_value );

integer_value = truxton_investigation_get_jurisdiction( investigation_handle );
printf( "Jurisdiction: " PRIu64 "\n", integer_value );

integer_value = truxton_investigation_get_status( investigation_handle );
printf( "Status: " PRIu64 "\n", integer_value );

integer_value = truxton_investigation_get_type( investigation_handle );
printf( "Type: " PRIu64 "\n", integer_value );
}
</source>

Note, the <code>PRIu64</code> in the sample code above is the new standard way of [https://en.wikipedia.org/wiki/C_data_types#Printf_and_scanf_format_specifiers formatting] a 64-bit integer in C.
Over the years, different compilers on different operating systems used different format specifiers for things, these <code>PRI</code> macros, along with some tricky string concatenation the compilers perform for you, allow you to maintain a single code base without a bunch of macro magic.

Truxton investigation get status - Revision history

Sam: Created page with "This retrieves the status of the investigation. It corresponds to the [InvestigationStatusID] column of the [Investigation] table. It should contain..."

Sam: Created page with "This retrieves the status of the investigation. It corresponds to the `[InvestigationStatusID]` column of the `[Investigation]` table. It should contain..."